home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / htmake.z / htmake
Text File  |  1998-10-30  |  28KB  |  595 lines
  1.  
  2.  
  3.  
  4. HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))                                                            HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      htmake - create a web site from a source document tree
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      hhhhttttmmmmaaaakkkkeeee [-_c] [-_l] [-_v] [-_x] [-_a _a_u_x_d_i_r] [-_b _b_u_t_t_o_n] [-_f _f_o_n_t] [-_h _h_o_m_e]
  13.      [-_n _n_a_m_e] [-_p _p_e_r_m_i_s_s_i_o_n_s] [-_s _s_u_b_d_i_r] [_s_o_u_r_c_e] destination
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _h_t_m_a_k_e is a "site compiler."  It creates a World Wide Web site (composed
  17.      of several hypertext documents and related objects (e.g., graphics) from
  18.      a source tree (expressed as a directory hierarchy).
  19.  
  20.      Pre-requisites to using htmake are: 1. a server supporting NCSA-compliant
  21.      Server-Side Includes ("includes"); and 2. a Netscape-style frames- and
  22.      JavaScript-capable browser/client/user-agent (such as Netscape 2.1).
  23.  
  24.      Includes (including `execs') must be enabled in the site's target
  25.      directory. You can do this by placing the following line into the target
  26.      directory's access control file: (ACF)
  27.  
  28.      The path to the source tree is either specified on the command line
  29.      [source] or, by default, is the current working directory (CWD).  The
  30.      generated site is written to the specified destination directory
  31.      (destination).
  32.  
  33.      _G_e_n_e_r_a_t_i_n_g _t_h_e _S_i_t_e When invoked, htmake reads (recursively) through the
  34.      source document tree and outputs the objects comprising the corresponding
  35.      web site.  The generated site is comprised of each of the objects found
  36.      within the source tree along with a set of HTML files.  htmake renames
  37.      source tree objects as is necessary to avoid name-space collisions (two
  38.      or more objects having the same name).  Appropriate permissions (allowing
  39.      reading or execution by other than owner, as is appropriate) are applied
  40.      to objects when they are written or copied to the destination directory.
  41.  
  42.      _S_i_t_e _H_o_m_e _P_a_g_e Unless inhibited by use of the -l switch, htmake
  43.      automatically generates a home page (entry page) for the site.  By
  44.      default this is named "index.shtml" (the home page's name can be changed
  45.      using the -h switch).  This means that, as default configured, the NCSA,
  46.      APACHE and most other webservers will automatically serve "index.html" if
  47.      a user specifies the destination directory as a URL.
  48.  
  49.      The home page consists of a title ("splash") graphic followed by a blank
  50.      line and a "Start" link.  All are centered along the page's vertical
  51.      axis.
  52.  
  53.      The splash graphic must be placed in the source document's root directory
  54.      under the name "title.gif" (which therefore requires it to be a GIF
  55.      image).  In lieu of a title graphic, the title page will show the
  56.      document's name (the last portion of the source directory path).  A GIF
  57.      image may be used in place of the text "Start" links (on the link) by
  58.      placing a file named "start.gif" in the document's root directory.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))                                                            HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))
  71.  
  72.  
  73.  
  74.      The remainder of the site is functionally organized into two levels.
  75.      Each level is expressed as one or more directories and subdirectories.
  76.  
  77.      The title page's start link links to the top level and the top level
  78.      links to the lower level. Clicking on the home page's start link will
  79.      display the site's "upper" level.
  80.  
  81. UUUUPPPPPPPPEEEERRRR LLLLEEEEVVVVEEEELLLL SSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEE
  82.      The upper level consist of a single page.  The page is a simple index and
  83.      is called the _selection page_.  The index is structured as a table, with
  84.      one index entry per row.
  85.  
  86.      _R_o_w _S_t_r_u_c_t_u_r_e Each row contains a combination of the following (from left
  87.      to right)
  88.  
  89.           {<Graphic> or <Label>} <Description>
  90.  
  91.      Graphic:
  92.           a "gif" image, usually an icon.  This is placed at the leftmost edge
  93.           of the row.
  94.  
  95.      Label:
  96.           the label is a short description of what the link does.  In lieu of
  97.           a graphic, the label is displayed.
  98.  
  99.      Description:
  100.           a [detailed] description.  This can be of any length, lines are
  101.           wrapped to the right of the graphic and label.
  102.  
  103.      htmake creates one row for each directory within the source directory.
  104.      All row components are part of a single, giant hotlink (one per row),
  105.      which points to one of several frame and page sets, each set representing
  106.      one of the subdirectories within each upper level directory.  These
  107.      represent the "lower level" of the source document.
  108.  
  109.      For both the gif and label files, the file name is the same as the
  110.      directory's name.  For the gif file, the extension must be `.gif' while
  111.      the label file's extension is `.lbl'.
  112.  
  113.      Thus, the label and gif files for <source>/Applications would be:
  114.  
  115.           `Applications.lbl'   and   `Applications.gif'
  116.  
  117.      respectively.
  118.  
  119.      The label file is used for two purposes: the first line of the file can
  120.      contain a string to be used as a label if no graphic is found for the
  121.      matching category file (the label will also be displayed if the user
  122.      turns off image loading, via the <IMG> tag's ALT="" attribute).
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))                                                            HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))
  137.  
  138.  
  139.  
  140.      The remaining lines of the file contain the text of the description (see
  141.      _R_o_w _S_t_r_u_c_t_u_r_e, above).  There can be as many lines as you like and they
  142.      can contain any HTML tags (including server side includes) you like.
  143.      Note that the entire description text will be hot (linked) and that
  144.      carriage returns ending lines will be parsed by the browser as whitespace
  145.      (according to HTML parsing rules which reduce any number of consecutive
  146.      whitespace characters to single spaces).
  147.  
  148.      _B_a_c_k_g_r_o_u_n_d You can add a tiled background (for display by Netscape-
  149.      compatible browsers) to the page by placing a `background.gif' image in
  150.      the source directory. htmake will detect the presence of the background
  151.      file and automatically modify the page's <BODY> tag to account for the
  152.      background attribute.
  153.  
  154.      _B_a_n_n_e_r _I_m_a_g_e A banner image may be placed at the very top of the page by
  155.      including a `banner.gif' image within the source directory.  No other
  156.      name is allowed.
  157.  
  158.      If you are using Netscape Navigator 2.0 or later, or another browser
  159.      which supports Netscape-style client-side image maps, you may have an
  160.      image map built into the page by creating a `banner.map' file within the
  161.      source directory.
  162.  
  163.      The map file should contain only <AREA> tags (no <MAP> ... </MAP>).
  164.  
  165.      htmake will detect the presence of the map file and automatically
  166.      generate the appropriate enclosing tags (<MAP> and <NOMAP>) and
  167.      incorporate the map file's contents into the page.
  168.  
  169.      _I_n_c_l_u_d_e_s _a_n_d _E_x_e_c_s You can have htmake include text before and after the
  170.      banner image (if present), after each index row, and at the bottom of the
  171.      page.  To do this, create one or more of the following files: (as befits
  172.      your needs)
  173.  
  174.      upper.inc
  175.           Text to be placed before banner graphic.  Text will span entire
  176.           page.
  177.  
  178.      middle.inc
  179.           Text to be placed after banner graphic but before index rows. Text
  180.           will span entire page.
  181.  
  182.      between.inc
  183.           Text to be placed immediately after banner graphic (will not be hot
  184.           [linked]).  Text will wrap underneath descriptions (to the right of
  185.           the graphic or label).
  186.  
  187.      lower.inc
  188.           Text to be placed after all index rows.  Text will span entire page.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))                                                            HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))
  203.  
  204.  
  205.  
  206.      You can also include text specific to each row by creating a `.inc' file
  207.      having the same name as the category file without the match value
  208.      ("Applications-" in the above examples).  Thus, the include for
  209.      "Applications-artwork.cgi" (assuming the match value was "Applications-")
  210.      would be:
  211.  
  212.           `artwork.inc'
  213.  
  214.      Each `.inc'lude file can contain any number of lines.  Text will be
  215.      parsed according to HTML rules (as with descriptions, described above).
  216.  
  217.      You can have htmake invoke a cgi script before and after the banner image
  218.      (if present), after each index row, and at the bottom of the page.  The
  219.      results (output text) of these scripts will be written into the page as
  220.      it is sent to the browser.  Note that because these scripts will be
  221.      outputting text into the middle of an existing HTML page, they should not
  222.      generate any the following tags:
  223.                     <HTML>   <HEAD>   <TITLE>   </TITLE>
  224.                     </HEAD>   <BODY>   </BODY>   </HTML>
  225.  
  226.      Specifying which script to run is similar to that for specifying include
  227.      files, the principal difference is the extension:
  228.  
  229.      upper.xeq
  230.           Script will be executed before banner graphic.  Output text will
  231.           span entire page.
  232.  
  233.      middle.xeq
  234.           Script will be executed after banner graphic but before index rows.
  235.           Output text will span entire page.
  236.  
  237.      between.xeq
  238.           Script will be executed immediate after row's description.  Output
  239.           text will wrap underneath descriptions (to the right of the graphic
  240.           or label).
  241.  
  242.      lower.xeq
  243.           Script will be executed after all rows have been displayed.  Output
  244.           text will span the entire page.
  245.  
  246.      You can also have executed a script specific to each row by creating a
  247.      `.inc' file having the same name as the category file without the match
  248.      value ("Applications-"in the above examples).  Thus, the include for
  249.      "Applications-artwork.cgi" (assuming the match value was "Applications-")
  250.      would be:
  251.  
  252.           `artwork.xeq'
  253.  
  254.      Note: htmake will automatically copy files with `.xeq' to the destination
  255.      directory, changing their extensions to `.cgi'.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))                                                            HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))
  269.  
  270.  
  271.  
  272. LLLLOOOOWWWWEEEERRRR LLLLEEEEVVVVEEEELLLL SSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEE
  273.      Clicking one of the upper level index's links (icon, label or
  274.      description), will cause the browser's document area to be divided into
  275.      three frames:  (actually four but one is not visible)
  276.                          +-------------------+
  277.                          |      BUTTONS      |
  278.                          +-------+-----------+
  279.                          |       |           |
  280.                          |       |           |
  281.                          |       |           |
  282.                          |       |           |
  283.                          | INDEX |    FORM   |
  284.                          |       |           |
  285.                          |       |           |
  286.                          |       |           |
  287.                          |       |           |
  288.                          +-------+-----------+
  289.  
  290.      _B_u_t_t_o_n_s In the button frame, htmake places a "button bar" (a row of
  291.      clickable buttons).  Each button represents a subdirectory within an
  292.      upper level directory (that is, a directory for which there is a link on
  293.      the selection page).
  294.  
  295.      Buttons can be textual or iconic.  When creating a button, htmake first
  296.      searches the associated directory for a file with the same name as the
  297.      directory but having a '.gif' (Graphic Interchange Format) extension.  If
  298.      a matching GIF file is found, it is copied to the destination directory.
  299.      The GIF will then be used for the button bar (it will be clickable).  If
  300.      htmake does not find a GIF file for the   directory, it then searches for
  301.      a file with a '.lbl' ("label") extension.  If one is found, the first
  302.      line of the file is used verbatim (the terminating newline is ignored)
  303.      for the button's value and is displayed in brackets [<button>].
  304.  
  305.      If neither an icon nor a label file is found then the name of the
  306.      directory is used.  When using the directory name, htmake will
  307.      automatically capitalize the first and lowercase the remaining letters of
  308.      the directory.
  309.  
  310.      Buttons within the bar are ordered alphabetically by their labels (the
  311.      directory's capitalized name is used if no label is found).  The ordering
  312.      is case sensitive.
  313.  
  314.      The buttons can be animated by creating an "activated" image for each
  315.      button, naming them
  316.  
  317.           <directory>.active.gif
  318.  
  319.      and placing them within the appropriate directory.  The button's active
  320.      image will be displayed whenever the button is selected (clicked on).  In
  321.      this sense, the button bar will appear to function like a set of old-
  322.      style car radio buttons, where one is pressed in to show its selection.
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))                                                            HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))
  335.  
  336.  
  337.  
  338.      htmake supports the placement of a tiled background into the button bar.
  339.      If one exists within the directory represented by the button bar, then it
  340.      will be used.  Otherwise, htmake will use the background specified in the
  341.      document's root directory (the source directory), if present--this is the
  342.      same image that htmake uses on the selection page.
  343.  
  344.      htmake can place a "banner" graphic at the top of the button bar (above
  345.      the button row).  Banner graphics must be named 'banner.gif'.  htmake
  346.      will first search the directory represented by the button bar for a
  347.      banner, then the document's root directory.
  348.  
  349.      In the button bar's upper left, above the button row and just before the
  350.      banner graphic, htmake places a "Home" link.  Clicking this jumps back to
  351.      the site's home page.  A GIF can be substituted for the button text by
  352.      placing a 'home.gif' graphic in the document's root directory.  (To
  353.      ensure that the banner graphic and home button are properly centered,
  354.      htmake checks for a 'nohome.gif' image.  If present, it will be placed to
  355.      the right of the banner, offsetting the effects of the 'home.gif' image.
  356.      This GIF should be transparent and the same dimensions as your
  357.      'home.gif.')
  358.  
  359.      _I_n_d_i_c_i_e_s Within the index frame, htmake places a list of forms (detailed
  360.      below).  Each entry within an index reflects one form ('.frm') file
  361.      within the subdirectory associated with the selected button bar button.
  362.      Clicking on an index entry causes the associated form to be executed
  363.      (and, hence, displayed in the lower right frame).
  364.  
  365.      You can have one or more arguments passed to any form by creating a
  366.      '.arg' file having the same name as the form ('.frm' file) to which you
  367.      want to pass the arguments (it must be in the same directory as the
  368.      form).
  369.  
  370.      The first line of the file will be passed to the form as part of the URL
  371.      invoking the form (using the <location>?<argument> CGI URL protocol).
  372.      The arguments are then available to your script using the CGI 'get'
  373.      method.  They are encoded using standard CGI URL encoding rules ("opaque
  374.      string").  Note that if your script uses self-referencing (URLs), it will
  375.      be necessary for you to pass these arguments back to your script as part
  376.      of a URL or [hidden] form parameter.
  377.  
  378.      Like with buttons, you may specify either an icon (graphic) or label to
  379.      be displayed for an index entry: (form) create a '.gif' or '.lbl' file
  380.      having the same name (but different extension) as a particular form.
  381.  
  382.      If htmake does not find a GIF file for the form, it then searches for
  383.      afile with a '.lbl' ("label") extension.  If one is found, the first line
  384.      of the file is used verbatim (the terminating newline is ignored) for the
  385.      button's value and is displayed in brackets [<button>].
  386.  
  387.      If neither an icon nor a label file is found then the name of the form is
  388.      used.  When using a form's name, htmake will automatically capitalize the
  389.      first and lowercase the remaining letters of the name and drop the
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))                                                            HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))
  401.  
  402.  
  403.  
  404.      extension ('.frm').
  405.  
  406.      Within the index, items are ordered alphabetically by their labels
  407.      (theform's capitalized name is used if no label file is found).  The
  408.      ordering is case sensitive.
  409.  
  410.      In order to highlight the currently selected index entry, if it is a
  411.      label, htmake displays it <STRONG>.  htmake also allows you to specify
  412.      'selected.gif' and 'unselected.gif' graphics which will be placed before
  413.      the currently selected and unselected index items, accordingly.  htmake
  414.      first looks for these graphics in the (sub)directory represented by the
  415.      selected button (for which the index is being built).  If either graphic
  416.      is missing, it next searches for an appropriately named graphic in the
  417.      parent directory (for which the containing button bar, index and frameset
  418.      are being built), and finally, if still not found, in the source
  419.      directory.
  420.  
  421.      If the directory for which the index is being built (the subdirectory of
  422.      sub- directory of the source directory) contains a _description.frm_,
  423.      then htmake will place that entry at the top of the index, regardless of
  424.      the names of any other forms.  This allows an obvious, consistent means
  425.      of self-documenting the site.
  426.  
  427.      Further, if a `describe.gif' and/or `undescribe.gif' graphic can be
  428.      found, then these will supplant `selected.gif' and `unselected.gif',
  429.      respectively. Otherwise the standard `selected.gif' and `unselected.gif'
  430.      will be used, if present.  This allows further highlighting of the
  431.      _description.frm_ index entry.  htmake uses the same search strategy in
  432.      looking for `describe.gif' and/or `undescribe.gif' as when looking for
  433.      `selected.gif' or `unselected.gif'.
  434.  
  435.      _F_o_r_m_s Forms are stand-alone executable scripts (e.g., C shell, shell or
  436.      PERL) which generate HTML pages (ostensibly forms).  They are identified
  437.      by having a '.frm' extension.  (They'll be renamed to '<form>.cgi' by
  438.      htmake.)
  439.  
  440. AAAACCCCCCCCEEEESSSSSSSSIIIINNNNGGGG TTTTHHHHEEEE GGGGEEEENNNNEEEERRRRAAAATTTTEEEEDDDD SSSSIIIITTTTEEEE
  441.      Assuming that you're already viewing the site's home page (which, if you
  442.      accepted the defaults and your webserver is traditionally configured, you
  443.      can do by specifying the destination directory as a URL to your browser),
  444.      clicking on the "Start" link will cause the _selection_ page to be
  445.      displayed.
  446.  
  447.      In turn, clicking on one of the selection page's links (a row, comprised
  448.      of icon, label and description), will cause a frame and button bar/index
  449.      set to be displayed.
  450.  
  451.      Selecting a button will change indicies while clicking on a particular
  452.      index item will cause a different form to be displayed.  Clicking on the
  453.      "Home" icon within the button bar will return you to the site's home page
  454.      and the bar's "Back" icon will jump you back to the selection page.
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))                                                            HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))
  467.  
  468.  
  469.  
  470. GGGGEEEENNNNEEEERRRRAAAATTTTEEEEDDDD SSSSIIIITTTTEEEE SSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEE
  471.      While the source tree is hierarchical, the output is basically flat--
  472.      normally all generated or copied documents reside in the destination
  473.      directory.  The one exception is if the -s flag is given to htmake.  In
  474.      this case, the site's home page document (index.html) is placed in the
  475.      target directory and the remaining objects (i.e., HTML, CGI and GIF
  476.      files) are placed in a designated subdirectory (subdest) within the
  477.      target directory.  If subdest does not exist then it is created.  (The
  478.      destination directory must always exist prior to beginning site
  479.      creation.)  All hypertext links between the home page document and other
  480.      site documents are maintained.
  481.  
  482.      Placing all but the index document within a subdirectory allows all but
  483.      the site's home page to be placed within a controlled access directory;
  484.      all users can view the home page without restriction but, by placing or
  485.      modifying an ACF (access control file) within the subdirectory, users can
  486.      be selectively restricted from accessing the remainder of the site (and
  487.      the home page can then note any access restrictions).
  488.  
  489. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  490.      _----_cccc   Clears the destination directory before compilation begins.  (If the
  491.           -s option is used, the subdirectory is cleared, too, if it exists).
  492.           ALL files except for those with a '.' prefix (normally not displayed
  493.           by ls) are deleted from the destination directory.  This is useful
  494.           if your source tree includes documents which have changed names
  495.           since the last time the site was generated.
  496.  
  497.           Note that if the -s switch is used, only the specified sub-directory
  498.           is cleared.  The [parent] destination directory is not altered.
  499.  
  500.           [The reason for having clearing being an option is to allow your
  501.           forms to take advantage of images or other documents residing in the
  502.           destination directory prior to site generation.)
  503.  
  504.      _----_xxxx   suppress use of labels if graphics are not present.
  505.  
  506.      _----_vvvv   Enables verbose mode: htmake will report each step of its processing
  507.           with a series of messages to STDOUT.  Given that site compilation
  508.           typically takes only a few seconds, this option is only for the most
  509.           neurotic.
  510.  
  511.      _----_llll   Prevents construction of the site's home page (whether expressly
  512.           identified using the -h switch).  All appropriate links will still
  513.           point to the home page.  This allows the use of a separately
  514.           constructed home page with the site.  (Use the -s switch to place
  515.           the generated site in a subdirectory within your site's principal
  516.           directory-- wherein your home page will reside).
  517.  
  518.      _----_aaaa _aaaa_uuuu_xxxx_dddd_iiii_rrrr
  519.           You can have htmake generate selection pages for additional
  520.           directories (other than the source directory) by specifying one or
  521.           more of them using this option (you must use a separate -a switch
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))                                                            HHHHTTTTMMMMAAAAKKKKEEEE((((1111))))
  533.  
  534.  
  535.  
  536.           for each directory you want to add).  No button bar/index page sets
  537.           will be built for these directories and no forms are
  538.           required/processed.
  539.  
  540.           The site's home page will (if generated) will include links to these
  541.           additional pages.
  542.  
  543.      _----_hhhh _hhhh_oooo_mmmm_eeee_pppp_aaaa_gggg_eeee
  544.           This option lets you specify a name for the site's home page (entry
  545.           point) other than the default "index.html."
  546.  
  547.           Note: most HTTP servers automatically seek an "index.html" document
  548.           when passed a URL without a file name.  This allows a URL to consist
  549.           only of a site path....
  550.  
  551.           _h_t_t_p://_a_n_y_w_h_e_r_e._c_o_m/
  552.  
  553.  
  554.           This will cause the server to qualify the URL as
  555.  
  556.           _h_t_t_p://_a_n_y_w_h_e_r_e._c_o_m/_i_n_d_e_x._h_t_m_l
  557.  
  558.      _----_pppp _pppp_eeee_rrrr_mmmm_iiii_ssss_ssss_iiii_oooo_nnnn_ssss _{{{{_````_uuuu_''''_,,,, _````_oooo_''''_,,,, _````_gggg_''''_}}}}
  559.           Any combination of `u', `o' and `g' can be used (but no letter more
  560.           than once).  The letters can be either upper or lowercase.
  561.  
  562.           Specify base access permissions for the generated page and any
  563.           related (copied) files.
  564.  
  565.           Only the user is ever given write permission on the page.  Group and
  566.           Other users are given read or execute access as is appropriate.
  567.  
  568.      _----_ssss _ssss_uuuu_bbbb_dddd_iiii_rrrr_eeee_cccc_tttt_oooo_rrrr_yyyy
  569.           Places all objects (pages, forms, etc.), except for the site's home
  570.           page, in the specified directory.  The home page is placed in the
  571.           destination directory.  All links between the home page and the
  572.           other site objects are properly resolved.
  573.  
  574.           The value of using this switch is when the site must be access-
  575.           controlled.  See _generated document structure_, above.
  576.  
  577.           The directory must be within the site's destination directory; if it
  578.           doesn't exist, it is created.
  579.  
  580. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  581.      Beware of using large icons, or long labels or directory names for
  582.      buttons. These can crowd button bars and cause the browser to wrap them
  583.      [to the next line].  Similar problems arise in indices for the same
  584.      causes.
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.